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Concerning Radio Frequency Interference 


The Texas Instruments Home Computer and peripherals generate and use radio 
frequency (RF) energy. If not installed and used properly (as outlined in the 
instructions provided by Texas Instruments), this equipment may cause interference to 
radio and television reception. 


This equipment has been type-tested and found to comply with the limits for a Class B 
computing device in accordance with the specifications in Subpart J of Part 15 of FCC 
Rules. These rules are designed to provide reasonable protection against radio and 
television interference in a residential installation. However, there is no guarantee that 
interference will not occur in a particular installation. 


If this equipment does cause interference to radio or television reception (which you 
can determine by turning the equipment off and on), try to correct the interference by 
one or more of the following measures: 


@ Reorient the receiving antenna (that is, the antenna for the radio or 
television that is “‘receiving’’ the-interference). 


m@ Change the position of the computer with respect to the radio or 
television equipment that is receiving interference. 


@ Move the computer away from the equipment that is receiving 
interference. 


@ Plug the computer into a different wall outlet so that the computer and 
the equipment receiving interference are on different branch circuits. 


If these measures do not eliminate the interference, please consult your dealer or an 
experienced radio/television technician for additional suggestions. Also, the Federal 
Communications Commission has prepared a helpful booklet, ‘‘“How to Identify and 
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Washington, D. C. 20402 
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peripherals is likely to result in interference to radio and TV reception. 
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SOFTWARE SWITCH OPTION ENTRIES 


Option Enter As 

BAUD RATE = 110, 300, 600, .BA = 300 (or desired rate) 
1200, 2400, 4800, or 9600 

DATA BITS=7 or 8 .DA =7 (or 8) 

PARITY =ODD, EVEN, or NONE .PA=O (or E or N) 

TWO STOP BITS .TW 

NULLS NU 

CHECK PARITY Ca 

ECHO OFF EC 

CRLF OFF .CR 

LF OFF LF 


SOFTWARE SWITCH OPTION DEFAULT VALUES 


Option Open/List Old/Save 

BAUD RATE Baud rate = 300 Baud rate = 300 
DATA BITS Data bits = 7 Option not allowed 
PARITY Parity = odd Option not allowed 
STOP BITS 1 stop bit 1 stop bit 

NULLS No nulls Option not allowed 
CHECK PARITY No parity check Option not allowed 
ECHO OFF Echo Option not allowed 
CRLF OFF Carriage return Option not allowed 

supplied 
LF OFF Linefeed supplied Option not allowed 


Examples: For RS232 Serial Interface: OPEN #1:*RS232.BA=1200" 
SAVE “RS232/2.BA =600.TW"’ 


For Parallel I/O Interface: OLD “PIO” 
LIST ‘‘PIO”’ 


Applicable to 
Parallel Port 


No 


Applicable to 
Parallel I/O 


No 
No 
No 
No 
Yes 
No 
Yes 
Yes 


Yes 
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INTRODUCTION 


The Texas Instruments RS232 Interface Card is a communications adapter featuring 
8-bit parallel and RS232 serial capabilities that enable you to connect a wide range of 
accessory devices to your TI Home Computer. With the RS232 Interface Card inserted 
into the Peripheral Expansion System, you can list programs on a printer, send and 
receive data from a terminal, exchange TI BASIC programs directly between TI Home 
Computers, and much more. By adding the Telephone Coupler (Modem) and certain 
Solid State Software™ Command Modules, your Home Computer can communicate 
with other computers and terminals over ordinary telephone lines. You can access an 
office computer or time-sharing network from your own home, using your TI Home 
Computer as a remote terminal to send and receive data. And you can write TI BASIC 
language programs which use EIA (Electronic Industry Association) Standard RS232C 
compatible devices, including printers, plotters, video display terminals, and other 
computers. In addition to its serial data feature, the RS232 Interface Card also has a 
parallel I/O (input/output) feature which handles input and output data that is in an 
8-bit format. The parallel I/O port interfaces directly with printers that accept dataina 
parallel format, saving you the expense of having an RS232 Interface on the printer. 


This manual shows you how to connect and test the RS232 Interface Card. Then 
common examples of how to use the card are given, followed by details of using TI 
BASIC with the RS232 Interface Card. The last section has additional, more advanced 
application examples. 
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SET-UP INSTRUCTIONS 


The steps involved in inserting the RS232 Interface Card into the Peripheral Expansion 
System and then checking its operation are included in this section. Please read this 
material completely before proceeding. 


Note: The Peripheral Expansion System has eight slots into which accessory cards can 
be inserted. The Peripheral Expansion Card must occupy slot number 1. (For 
information about setting up the peripheral system, refer to the Peripheral Expansion 
System owner’s manual.) If you have a Disk Memory Drive in the Peripheral 
Expansion System, the Disk Drive Controller Card must be in slot number 8. Other 
cards can be inserted in any of the remaining slots. 


CAUTION 
These electronic components can be damaged by 


static electricity discharges. To avoid damage, 
do not touch the connector contacts. 


Once you’ve unpacked the unit, you’re ready to insert the RS232 Interface Card into 
the Peripheral Expansion System. (Save the packing material for storing or 
transporting the unit.) 


\), 
Inserting the RS232 Interface Card P) | 


1. 


2. 


First turn off the computer console and all attached devices. 


WARNING: TO AVOID DAMAGING ACCESSORY CARDS, WAIT TWO (2) MINUTES 
AFTER TURNING OFF THE UNIT FOR THE POWER TO DISCHARGE BEFORE 
PROCEEDING. 


Remove the top from the peripheral system by lifting the back edge of the top and pulling up. 


The label identifying the RS232 Interface Card is on the top of the card. An indicator light 
is on one side of the card. When the card is active, this light is lit and is visible at the front 
of the peripheral system. Hold the RS232 Interface Card with the indicator light facing 

the front of the peripheral system. 


. Carefully align the card with the desired slot and press the card firmly down into the slot. 


Replace the top on the Peripheral Expansion System by sliding the front edge under the 
extension on the front of the unit and firmly pressing down on the back edge of the top. 
Do not run the system without the top in place because the top ensures proper 
ventilation. Note: If the top does not fit properly, remove the card and realign it in the slot, 
remembering to press down firmly until the connection is made. 


CAUTION 
Always disconnect the Peripheral Expansion System before 
moving the computer console. The cable connecting the 
console and peripheral system is not designed to support the 
weight of the units. To prevent damage, always disconnect 
all devices before moving any part of your Home Computer 


system. For long distance moves, remove all cards from the 
Peripheral Expansion System. Then, repack the devices in 
their original packing material. 
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Testing the RS232 Interface Card 


1. The power switch is located on the front of the Peripheral Expansion System in the 
lower left-hand corner. Turn on the peripheral system, monitor, and console in that 
order. 


2. A light should briefly come on in the position where you have inserted the RS232 
Interface Card. Each time the computer system accesses the RS232 Interface Card, 
its corresponding light comes on. Note that the intensity and duration of the light 
varies, depending on the operation being performed within the system. 


3. If the light does not come on, the corresponding card may not be properly inserted. 
Repeat the ‘‘Set-Up Instructions”’ procedure. If you still have difficulty, see ‘‘In Case 
of Difficulty’’ on page 20. 


Removing the RS232 Interface Card 


1. Turn OFF the Peripheral Expansion System, computer console, monitor, and any 
other attached accessories. 


2. Wait two minutes and then remove the top from the peripheral system. 
3. Remove any cables attached to the RS232 Interface Card. 

4. Pull up the wire handles on the ends of the card. 
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. Firmly pull on the handles to remove the card from its slot in the peripheral 
system. 


Connecting Accessory Devices 


Once the RS232 Interface Card is properly inserted into the Peripheral Expansion 
System, other devices can be attached by cable to one or both of the connectors on the 
back of the card. One of the connectors is a parallel I/O port which enables your Home 
Computer to be connected to an impact printer. It is a 16-pin connector. The other 
connector is an RS232 serial I/O port for connection to RS232C-compatible devices. It 
is a 25-pin connector. An optional Y-cable (sold separately) can be attached to the 
RS232 connector to allow operation with two serial I/O devices. Note: If both serial I/O 
devices are used, they are referred to as RS232/1 and RS232/2. 


For your convenience, Appendix B contains reference information about cables and 
Appendix C provides pin diagrams. 


Addressing Accessory Devices 


In computer software programs written for use with the RS232 Interface Card, the 
circuitry through which data passes to and from external devices is called a ‘‘port,”’ 
and each of these ports has a name. Usually, the serial I/O port is called RS232 or 
RS232/1, and the parallel I/O port is called PIO or PIO/1. If a Y-cable is connected to 
the serial connector on the RS232 Interface Card, a second serial I/O port can be 
addressed. This second port is called RS232/2. 


You can also insert two RS232 Interface Cards in the Peripheral Expansion System. If 
this is done, the additional serial I/O port is referred to as RS232/3. By connecting a 
Y-cable to the serial connector of the second card, a fourth serial I/O port is available, 
which is referred to as RS232/4. The additional card also provides a second parallel I/O 
port, which is referred to as PIO/2. 


USING TI BASIC 


After you’ve attached a peripheral to the RS232 Interface Card, the peripheral’s 
operation can be controlled by using TI BASIC commands and statements to input and 
output data. These commands and statements are summarized here and are explained 
in detail in the ‘“‘Statements and Commands’”’ section. 


@ OPEN, CLOSE, INPUT, PRINT—Statements used to send and receive 
data between your Home Computer and other computers or 
accessories. 


m@ OLD, SAVE—Commands used to send programs from one Home 
Computer to another. 


@ LIST—Command used to print or display a copy of a program. 


When communicating with the RS232 Interface Card, TI BASIC recognizes five device 
or file names. The first three names refer to the serial I/O ports. RS232 and RS232/1 
are equivalent and reference the first serial I/O port. RS232/2 references the second 
serial I/O port. The remaining two names refer to the parallel I/O port. PIO and PIO/1 
are equivalent; both names address the parallel I/O port. Whenever an OPEN 
statement or a LIST, OLD, or SAVE command references one of the above names, all 
output or input is directed to or entered from the RS232 Interface Card. 
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Software Switch Options 


Computer accessories often require switches to give instructions to the computer. 
These switches are sometimes a physical part of the product and are set by hand. With 
the RS232 Interface Card, however, these switches are programmed into an integrated 
circuit contained in the card to provide more flexibility. Since these switches are part 
of the card’s ‘‘software,’’ they are called software switch options. 


Nine particular operations of the RS232 Interface are controlled with software switch 
options. The first four describe the characteristics of the computer or accessory with 
which you want to communicate. Note: These four operations are not used with the 
parallel I/O port. 


m@ BAUD RATE—The rate (in bits per second) at which data is transferred. 
@ DATA BITS—The number of bits of data in each character transferred. 


@ PARITY—The addition of a check bit to allow checking data 
transmission for errors. 


m@ STOP BITS—The number of bits sent at the end of each character. 


The other five software switch options make adjustments in the operations performed 
by your TI Home Computer. 


m@ CHECK PARITY—An option which verifies the data of each character 
received. Note: Also not used with the parallel I/O port. 


@ NULLS—An option that adds six null characters to be transmitted after 
each carriage return to allow for printer carriage mechanism timing. 


@ ECHO OFF—An option to suppress retransmission of each character 
received at the sender’s device. 


@ CARRIAGE RETURN and LINEFEED OFF—An option to suppress 
automatic addition of a carriage return and linefeed to each variable- 
length DISPLAY-type record. 


@ LINEFEED OFF—An option to suppress automatic addition of a linefeed 
to each variable-length DISPLAY-type record. A carriage return is still 
automatically added. 


These nine software switch options allow you to match your TI Home Computer to the 
operating characteristics of the accessory attached to the interface card. You do this by 
listing the switch options desired when you are entering the TI BASIC command or 
statement needed. All nine options are available with the serial I/O port, but only the 
last four can be included when you send or receive data through the parallel I/O port. 


The software switch options must be designated in the OPEN statement and in the 
LIST, OLD, and SAVE commands. Since CLOSE, INPUT, and PRINT statements 
operate with previously opened files, switch options are not necessary. 


To make things as easy as possible for you, the RS232 Interface assumes certain 
switch settings, called default values. You only have to specify those settings you need 
to change from the default values. 


Software Switch Options and Default Values 


SOFTWARE SWITCH OPTION DEFAULT VALUES 
Applicable to 


Option Open/List Old/Save Parallel I/O 
BAUD RATE Baud rate = 300 Baud rate = 300 No 
DATA BITS Data bits=7 Option not allowed No 
PARITY Parity = odd Option not allowed No 
STOP BITS 1 stop bit 1 stop bit No 
NULLS No nulls Option not allowed Yes 
CHECK PARITY No parity check Option not allowed No 
ECHO OFF Echo Option not allowed Yes 
CRLF OFF Carriage return Option not allowed Yes 
supplied 
LF OFF Linefeed supplied Option not allowed Yes 


If you want to specify different values, the following software switch options can be 
entered. In a file name the switch options follow RS232, RS232/1, or RS232/2 for the 
serial I/O port or PIO or PIO/1 for the parallel I/O port. 


SOFTWARE SWITCH OPTION ENTRIES 


Option Enter As Function 

BAUD RATE=110, 300, .BA=300 (or desired — Sets the transmission 
600, 1200, 2400, rate) rate. 
4800, or 9600 

DATA BITS =7 or 8 .DA=7 (or 8) Determines the number 
of data bits in each 
character. 

PARITY =ODD, EVEN, .PA=O (or E or N) Determines type of parity 

or NONE checking. 

TWO STOP BITS .TW When this switch is on, 
stop bits are used. 

NULLS .NU When this switch is on, 
nulls are used. 

CHECK PARITY .CH When this switch is on, 
parity checking is 
performed. 

ECHO OFF EC When this switch is on, 
the echo feature is turned off. 

CRLF OFF .CR When this switch is on, 


the carriage return and 
linefeed options are 
turned off. 

LF OFF .LF When this switch is on, 
the linefeed feature is 
turned off. 


The first three options assign values to a switch and must include an equals sign (=). 
The remaining six switches are of the ‘‘on-off’’ variety and, as shown, are entered with 
a decimal point and then the two-letter designation. The switch options may be listed 
in any order in your program statement or command. 
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Statements and Commands 


In this section, TI BASIC statements and commands are discussed only as they relate 
to the RS232 Interface Card. For a more general explanation of TI BASIC, see the 
BASIC Reference Section of the User’s Reference Guide. 


The OPEN Statement 


The OPEN statement prepares a TI BASIC program to use data files with accessory 
devices. When used with the RS232 Interface Card, it links the attached peripheral toa 
file-number and sets the software switch options to control the interface operations. 


The format for the OPEN statement with the RS232 Interface Card is: 
OPEN #file-number: ‘‘file-name[.software switch options]’’/,file-attributes] 


@ File-number is a numeric expression that evaluates to an integer 
between 1 and 255. 


@ File-name is a string expression containing one of the five names used 
with the RS232 Interface Card: RS232, RS232/1, or RS232/2 when 
using the serial I/O port, or PIO or PIO/1 when using the paraliel I/O 
port. The file-name is optionally followed by a list of software switch 
options. For those options not listed, the computer assumes the default 
values listed in the “‘Software Switch Options”’ section. 


@ File-attributes are string expressions, separated by commas, which 
specify the length and format of records, the file organization, and how 
the file is accessed. The possible entries and default values for the 
RS232 Interface Card are: 


RS232 Interface 
Entry Card Default 


file-organization: SEQUENTIAL only (RELATIVE SEQUENTIAL 
files cannot be used) 


file-type: DISPLAY or INTERNAL DISPLAY 
open-mode: INPUT, OUTPUT, UPDATE, or UPDATE 
APPEND 


record-type: FIXED or VARIABLE [record length] VARIABLE 80 


1] 


The following examples are open statements for serial I/O. >) 


Example 1: OPEN #1: ‘RS232” 
Example 2: OPEN #A: “RS232.BA =9600.EC.CH” 
Example 3: OPEN #B: “AS$’’,FIXED 32 
where: B = 3 
AS = RS232/2.TW.BA=110 


The following are examples for parallel I/O. 


Example 4: OPEN #1: “‘PIO.EC”’ 
Example 5: OPEN #2: ‘‘PIO/1.EC.LF’’ 


In the first example, all default values are assumed on port 1. In the second example, 
file A on port 1 has a baud rate of 9600, the echo feature is turned off, and parity 
checking will occur. The device opened in the third example is attached to port 2, two 
stop bits are transmitted, the baud rate is 110, and the record type is set to a fixed 
length of 32 characters. In the fourth example, file 1 is opened on the parallel I/O port, 
and the echo feature is turned off. In the last example, file 2 is opened on the parallel 
I/O port and both the echo and line feed features are turned Off. 


The CLOSE Statement 


The CLOSE statement ‘‘closes’’ or discontinues the association between the file 
specified by the file-number and a program. 


The format for the CLOSE statement is: 


CLOSE #file-number 
The INPUT Statement 


When you use the INPUT statement with a device connected to the RS232 Interface 
Card, data can be transmitted from the device and assigned to the variables listed in 
the statement. The format for this form of the INPUT statement is: 


INPUT #file-number:variable-list 


To use the INPUT statement with a device attached to the RS232 Interface Card, the 
device must be opened in INPUT or UPDATE mode. 


@ File-number is a numeric expression that evaluates to an integer 
between 1 and 255. 


@ Variable-list is a group of variables to which data are assigned. 


The number of characters returned by the INPUT statement depends on the record 

type specified in the OPEN statement. For FIXED length or INTERNAL data type 

records, data are accepted from the device until (1) the number of characters equals 

the record length specified in the OPEN statement or (2) CLEAR is pressed on the main 

console, which stops the program. For VARIABLE length records, input is accepted 

from the RS232 Interface Card until (1) a carriage return (or ENTER) is pressed, (2) the Dy 
maximum record length specified in the OPEN statement is reached, or (3) CLEAR is 

pressed on the main console, stopping the program. 
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An added feature of the RS232 Interface Card is its editing capability. Before pressing 
the carriage return or ENTER key, the person sending data from a terminal can delete 
characters and recheck the data before transmission. To use the editing feature, follow 
this procedure: 


1. Be sure the OPEN statement for this device specifies DISPLAY type data. 


2. Be sure the echo and edit capability is functioning (do not specify ECHO OFF in the 
corresponding OPEN statement). 


3. Press the terminal’s DELETE key (decimal code 127). This causes the previously 
transmitted character to be removed from the RS232 Interface buffer so that it is 
not sent to the computer. The deleted character is echoed back to the sending 
terminal. 


4. To see what remains in the RS232 buffer after several deletions, press the 
terminal’s CONTROL R key (decimal code 18). This sends a carriage return, a 
linefeed, and the buffer contents back to the sending terminal so that you can see 
what is ready to be entered. 


If the ECHO OFF (.EC) software switch option or INTERNAL data is specified in the 
OPEN statement, the editing features are ignored. Pressing DELETE or the CONTROL 
R key on the terminal, in this case, results in the corresponding code being stored in 
the RS232 Interface buffer. 


The PRINT Statement 


To send data from the Home Computer to an accessory device via the RS232 Interface 
Card, the format for the PRINT statement is: 


PRINT #file-number/|:print-list] 


@ File-number is a numeric expression that evaluates to an integer 
between 1 and 255. 


m@ Print-list is a group of variables to which data is assigned. 
The device must be opened in the OUTPUT or UPDATE mode. 


When data is transmitted to a device through the RS232 Interface Card, a carriage 
return and linefeed code are sent after each record unless: 


m@ INTERNAL type data or FIXED length records was specified in the 
corresponding OPEN statement. 


m@ CARRIAGE RETURN — LINE FEED OFF (.CR) or LINE FEED OFF (.LF) 
was specified in the OPEN statement. 
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Two Home Computers can print and input to each other through their respective 
RS232 serial or parallel I/O ports. While one computer prints data out, the other can 
receive the data with an INPUT statement. Since data entered on the console of a 
Home Computer is immediately displayed, the receiving RS232 serial or parallel I/O 
interface should not echo data back. List the ECHO OFF (.EC) option and LINE FEED 
OFF (.LF) option in the OPEN statement when two Home Computers print and input to 
each other. The first example in the ‘‘Common Applications”’ section illustrates how 
two Home Computers can communicate with each other. 


Note: When you use the parallel I/O port, specify the ECHO OFF (.EC) feature in the 
OPEN statement. 


The LIST Command 


Program lines can be displayed on an accessory device through the RS232 Interface 
Card by using the LIST command in the following format: 


LIST ‘‘file-name[.software switch options]’’[:line-list] 


Here again the file-name must be RS232, RS232/1, or RS232/2 when using the serial 
I/O port, or PIO or PIO/1 when using the parallel I/O port. The software switch options 
and their default values are listed in the ‘‘Software Switch Options”’ section. The line- 
list is any valid list as explained in the BASIC Reference Section of the User’s 
Reference Guide. 


The following examples are list statements for serial I/O. 


Example 1: LIST “RS232” 
Example 2: LIST “RS232/1.BA=600.DA=8.PA=E" 
Example 3: LIST “RS232/2.BA=1200": 100-200 


The following examples are list statements for parallel I/O. 


Example 4: LIST “PIO” 
Example 5: LIST “‘PIQ/1": 100-200 


The first example assumes all the default values through port 1. The second example 
also uses port 1 but changes the baud rate to 600, the data bits to 8, and the parity to 
even. The third example uses port 2 and a baud rate of 1200. The first two examples 
list all program lines in memory while the third lists the lines between 100 and 200, 
inclusive. The last two examples list similar information via the parallel I/O port. 
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The SAVE and OLD Commands 


Programs can be exchanged between TI Home Computers when they are connected by 
modems over the telephone network or if their respective RS232 Interface Cards are 
directly cabled together. The SAVE and OLD commands are used in the following 
formats: 


SAVE ‘“‘file-name[.software switch options]”’ 
OLD “‘file-name[.software switch options]”’ 


The file-name must be RS232, RS232/1, or RS232/2 when using the serial I/O port or 
PIO or PIO/1 when using the parallel I/O port. For the RS232 serial I/O ports, the only 
software switch options allowed are baud rate (.BA) and number of stop bits (.TW). For 
the parallel I/O port, no switch options are allowed. The number of data bits is always 
8 when exchanging programs. The default values are shown in the “Software Switch 
Options”’ section. Corresponding SAVE and OLD commands must specify the same 
baud rate and number of stop bits when using the serial I/O port. 


The following examples are save and old commands for serial I/O. 


Example 1: SAVE “RS232/2.BA=600.TW" 
Example 2: OLD “RS232.BA=600.TW" 


The following examples are save and old commands for parallel I/O. 


Example 3: SAVE “PIO” 
Example 4: OLD “PIO/1”’ 


See the ‘‘Common Applications”’ section for the procedure required to exchange 
programs. 


The following table indicates the speed at which one record is exchanged between 
computers when using the I/O ports. The transfer time, expressed in seconds, is next 
to the baud rate you are using. 


TRANSFER TIMES FOR A 256-BYTE RECORD 


Baud Rate Seconds 


RS232 Serial I/O 
110 20.0 

300 8.6 

600 4.3 

1200 20 

4800 0.5 

9600 0.3 

O 


Parallel I/O 
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COMMON APPLICATIONS 


One common application of your RS232 Interface Card involves communicating with 
another TI Home Computer. Two examples are shown here. The first shows how 
messages can be exchanged between TI Home Computers, and the second illustrates 
how a TI BASIC program can be transferred from one TI Home Computer to another. 
The examples assume that both TI Home Computers have RS232 Interface Cards 
which are connected by a cable. However, the same procedure works using telephone 
lines when each line has a TI Telephone Coupler (modem) attached to the RS232 
Interface Card. 


Communication between Home Computers 


In this example, two TI Home Computers are sending and receiving messages through 
a cable attached to the serial I/O, RS232 port (port 1) of each RS232 Interface Card. 
(See Appendix B for cable information for Home Computers and modems.) Below are 
the program listings: one for User A and one for User B. 


User A enters the program on the left into computer A; User B enters the program on 
the right into computer B. Then User B’s program should be RUN before User A’s. 
When both programs are running, User A sends the first message. When a message is 
entered on User A’s computer, it is transmitted via the RS232 Interface Card and 
displayed on User B’s screen. Then User B can enter a message to be sent to User A. 
Messages are sent by typing the words and then pressing ENTER. This process of 
alternately sending messages between A and B can continue until the programs are 
stopped by pressing CLEAR on both computers. 


100 REM-USER A 100 REM-USER B 

200 OPEN #1:°RS232.EC.LF”, 200 OPEN #1:""RS232.EC.LF”’, 
VARIABLE 255 VARIABLE 255 

300 INPUT AS 300 INPUT #1:AS 

400 PRINT #1:AS 400 PRINT AS 

900 INPUT #1:BS 500 INPUT BS 

600 PRINT BS 600 PRINT #1:BS 

700 GOTO 300 700 GOTO 300 

800 END 800 END 


Note that in line 200, the serial I/O port is opened, and the echo feature is turned off. 
The reason that the echo feature is turned off is because, in this example, information 
is to be transmitted in only one direction at a time. Thus, it is not necessary to have 
data echoed back. However, RS232 serial I/O ports may send and receive information 
simultaneously. When such two-way transmission is desired, the echo feature must be 
used. Parallel I/O ports, on the other hand, can transmit information in only one 
direction at a time. Therefore, they do not require information to be echoed back. If 
transmission is by parallel I/O ports, the echo feature must be turned off. To do this, 
the term RS232 in line 200 is simply replaced by the term PIO. 
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Exchanging Programs with SAVE and OLD Commands 


This example demonstrates transferring a TI BASIC program from one TI Home 
Computer to another. After the program transfer is complete, the receiving computer 
can use the program just as if it had been entered there. This procedure is useful for 
exchanging programs without having to reenter the program statements from the 
keyboard. 


If transmission is over the telephone, programs are exchanged by the following 
procedure: 


1. Call the other user; then place your phone in the modem. See the modem owner’s 
manual for specific instructions. 


2. The sender types SAVE ‘*‘RS232” or SAVE ‘‘RS232/1”’ (or ‘““RS232/2”’ if the second 
serial I/O port is used) and presses ENTER. 


3. The receiver types OLD “RS232”’ or OLD ‘*RS232/1”’ (or ‘‘RS232/2”’ if the second 
serial I/O port is used) and presses ENTER. 


4. The number 255 then appears at the top center of each computer display. Once the 
link is established, this value is replaced by the number of 256-character records 
remaining to be exchanged. This value decreases as each record is transferred. 
When it reaches zero, the complete program has been transmitted. 


5. If the number 255 remains on the screen longer than 10 seconds, the person at the 
receiving end must press CLEAR and reenter the OLD command. 


Note: If the two computers are attached by direct cable through the parallel I/O ports, 
the procedure is the same as in Steps 2 through 5, except that the SAVE and OLD 
commands should be SAVE “PIO” and OLD “‘PIO”’. 


These are just two examples of ways to use the RS232 Interface Card. In addition to TI 
BASIC programs, certain Command Modules also use the RS232 Interface Card. For 
example, the Terminal Emulator module allows you to use the interface unit and 
Telephone Coupler to access time-sharing computer services. Check with your local 
dealer for information about these modules and other accessories and services 
available for use with the RS232 Interface Card. 


ADVANCED EXAMPLES 


The three example programs in this section illustrate three tasks commonly performed 
by an RS232 Interface Card. 


Example 1: Printing a Report 


This program prints a table listing the numbers from 1 to 10, including the squares 
and cubes of these numbers, using the parallel I/O port. 


100 OPEN #1:""PIO” 

200 PRINT #1:°X", “XA 2", “X AB" 
300 FOR K=1 TO 10 

400 PRINT #1:K,KA 2,K AS 

500 NEXT K 

600 CLOSE #1 

700 END 


Line 100 opens the attached device using the default software switch options. Line 200 
prints a heading. Lines 300-500 loop through the whole numbers from 1 to 10, 
inclusive, and print the table. Line 600 disassociates the specified file from the RS232 
Interface Card. 


Example 2: Two-way Communication between Computer and Terminal 


This program can be used by a Home Computer with a video display terminal 
connected to serial I/O port 1 of the RS232 Interface Card. 


100 CALL CLEAR 

200 OPEN #1:"RS232/1.BA=9600", VARIABLE 112 

300 INPUT “TYPE MESSAGE: *:X$ 

400 PRINT #1::‘*MESSAGE FROM HOME COMPUTER: "’:X&:: 
900 PRINT #1:::"° TYPE MESSAGE: ”’; 

600 INPUT #1:XS 


800 GOTO 300 


The terminal is opened in line 200, specifying a baud rate of 9600. The other software 
switch options have the default values. VARIABLE records are specified because the 
message will vary in length. The maximum number of characters accepted by an 
INPUT statement is 112, so this is the value specified as the maximum record length. 
If you are using a mechanical terminal, turn on the NULLS (.NU) software switch 
option. This gives the carriage return time to move back to the first column. 


The program first accepts a message from the Home Computer and transmits it to the 
terminal (lines 300 and 400). In lines 500-700, the terminal user is prompted to enter a 
message which is displayed on the Home Computer screen. Line 800 lets this 
exchange of messages continue until CLEAR is pressed to stop the program. 
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Example 3: Specifying Different Software Switches on the Same Port 


This program demonstrates how you can simultaneously use a single device in more 
than one way. Initially, the program opens a terminal as files 1, 2, and 3 on port 1. 
Line 100 specifies that output to file #1 should include a return and linefeed after each 
record. Line 110 indicates that data from file #2 will have variable length ASCII text 
and will not be echoed back to the terminal. Lines 110 and 120 show that data will be 
printed on file #3 and the cursor will stay on the same line after it is printed. 


100 OPEN #1:""RS232" 

110 OPEN #2:"RS232.EC" 

120 OPEN #3:""RS232.CR" 

130 PRINT #3:"ENTER THE WORD PASSWORD” 
140 INPUT #2:AS 

150 IF AS = “PASSWORD” THEN 180 

160 PRINT #1: TRY AGAIN” 

170 GOTO 130 

180 PRINT #1:"-PASSWORD IS OK” 

190 GOTO 130 
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SERVICE INFORMATION 
In Case of Difficulty 


If the RS232 Interface Card does not appear to be working properly, check the 
following: 


—" 


Power — Be sure the peripheral system is plugged in and turned on. Also, check to 
be sure that the fuse is not blown by looking at the fuse to see if the wire is 
unbroken. 


~ 


Card Position — Turn the power OFF, wait two minutes, and remove the top from 
the peripheral system. Verify that all cards are inserted properly and then replace 
the top. 


a 


Home Computer — Check to see that the Home Computer works properly with all 
accessories disconnected. 


~ 


Peripheral Expansion System — Check for proper connection between the console 
and peripheral system. 


m 


Cables — Data Communication Equipment (DCE*) devices, such as modems and 
other home computers, require the connection shown in Appendix B. Data 
Terminal Equipment (DTE*) devices, such as terminals and printers, require a 
different cable, also shown in Appendix B. Be sure the correct cable is being used. 
Check for loose or broken leads. Be sure cables are plugged into control ports. If 
you wish to use both RS232 ports simultaneously, an optional Y-cable is available. 


Y 


Proper Software Switch Options Selection — Even when all hardware is operating 
properly, the RS232 Interface Card can appear to malfunction if improper software 
switch optioris have been selected. Check the requirements of the terminal or 
modem attached to the RS232 Interface Card and be sure they correspond to the 
options selected in the OPEN statement and in the LIST, OLD, or SAVE commands. 
A 300-baud printer will not operate if the RS232 Interface Card is opened at 1200 
baud. Refer to your printer manual for the option selection procedure. If maximum 
ease of programming is desired, set your printer or modem to the default values 
specified in the ‘‘Software Switch Options”’ section. When communicating between 
Home Computers, omitting the ECHO OFF (.EC) or LINEFEED OFF (.LF) options in 
an OPEN statement may cause unpredictable results. 


~] 


. Test Mode — In regard to other modems and terminals, if the device has a test or 
local mode, use it to verify that the device is working properly when it is 
disconnected from the RS232 Interface Card. 


*Per the EIA RS232C Standard 
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If the RS232 Interface Card or attached devices still do not appear to be working 
properly, first turn all power off. Next, remove the RS232 Interface Card from the 
Peripheral Expansion System and the cables to attached devices. Then follow these 
steps: 


1. See if the Home Computer is working properly with only the Peripheral 
Expansion System connected. Turn off the Home Computer. Disconnect all 
accessories. Check that the Peripheral Expansion System (without the RS232 
Interface Card in its slot) is connected. Turn on the Home Computer. Press any 
key and the master selection list appears. Now select TI BASIC. Type: 

OPEN #1:°°RS232”’ and press ENTER. The error message ‘I/O ERROR 00” should be 
displayed, indicating that the device named could not be opened. (This is the result 
expected if the RS232 Interface Card is not inserted in the Peripheral Expansion 
System.) 


2. Check that the RS232 Interface Card is working properly. Refer to the ‘‘Set-Up 
Instructions’’ section and reconnect the RS232 Interface Card. Type: OPEN 
#1:°"RS232”’ and press ENTER. Contents of the screen should scroll up two lines, 
indicating that the device named has been opened. 


3. If any device when reattached to the RS232 Interface Card still does not work, then 
the device or its cable may be faulty. Cable pin connections (pinouts) are defined in | 
Appendix B. | 


o 4. If none of the above procedures corrects the difficulty, consult “If You Have 
@ Questions or Need Assistance”’ or see the ‘‘Maintenance and Service Information’”’ 
| section of the User’s Reference Guide. 


Exchange Centers (Local Service Options) 


If your RS232 Interface Card requires service, instead of returning the card to a service 
facility for repair or replacement, you may elect to exchange the card for a factory- 
reconditioned RS232 Interface Card of the same model (or equivalent model specified 
by TI) by going in person to one of the exchange centers which have been established 
across the United States. A handling fee will be charged by the exchange center for in- 
warranty exchanges of the RS232 Interface Card. Out-of-warranty exchanges will be 
charged at the rates in effect at the time of the exchange. 


To determine if there is an exchange center in your area, look for Texas Instruments 
Exchange Center in the white pages of your telephone directory, or look under the 
Calculator and Adding Machine heading in the yellow pages. Please call the exchange 
center for availability and exchange fee information. Write the Consumer Relations 
Department for further details and the location of the nearest exchange center. 


If You Have Questions or Need Assistance 


If you have questions concerning RS232 Interface Card repair, or peripheral or 
software purchase, please call our Customer Relations Department at 800-858-4565 
(toll free within the contiguous United States except Texas) or 800-692-4279 within 
Texas. The operators at these numbers cannot provide technical assistance. 


For technical questions, such as programming, specific applications, etc., you can call 
806-741-2663. Please note that this is not a toll-free number, and collect calls cannot 
be accepted. 


As an alternative, you can write to: 
Consumer Relations Department 
Texas Instruments Incorporated 
P.O. Box 53 
Lubbock, Texas 79408 


Because of the number of suggestions which come to Texas Instruments from many 
sources containing both new and old ideas, Texas Instruments will consider such 
suggestions only if they are freely given to Texas Instruments. It is the policy of Texas 
Instruments to refuse to receive any suggestions in confidence. Therefore, if you wish 
to share your suggestions with Texas Instruments, or if you wish us to review any 
programs which you have developed, please include the following statement in your 
letter: 


‘All of the information forwarded herewith is presented to Texas 
Instruments on a nonconfidential, nonobligatory basis; no relationship, 
confidential or otherwise, expressed or implied, is established with Texas 
Instruments by this presentation. Texas Instruments may use, copyright, 
distribute, publish, reproduce, or dispose of the information in any way 
without compensation to me.” 
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APPENDIX A — Error Codes 


Listed below are the error codes related to the operation of TI BASIC programs that 
use the RS232 Interface Card. 


OPEN: 


INPUT: 


PRINT: 


OLD: 


SAVE: 


CODE 00 — Device named in the statement or command cannot be 
opened. 

CODE 02 — The software switch option entry is in error, such as 
incorrect first two characters of an option, invalid BAUD rate, 
or incorrect number of data bits, as well as RELATIVE record 
type specified in the OPEN statement. 

CODE 06 — A hardware error occurred and the device cannot be opened. 


CODE 24 — INTERNAL data type record is too large to be read into the 
buffer space allocated. 

CODE 26 — Some type of hardware error occurred. Also caused by 
pressing CLEAR to stop the reception of a pending or in 
progress operation. 


CODE 36 — See INPUT code 26. 


CODE 50 — Program cannot be loaded from the specified device. 

CODE 52 — Attempting to use .EC, .CR, .LF, .NU, or .DA switch with 
OLD statement. Also see OPEN code O2. 

CODE 54 — The program is too large to be loaded. 

CODE 56 — See INPUT code 26. 


CODE 60 — Program cannot be saved to the specified device. 

CODE 62 — Attempting to use .EC, .CR, .LF, .NU, or .DA switch with 
SAVE statement. Also see OPEN code O2. 

CODE 66 — See INPUT code 26. 


MISC ERROR CODES: 


CODE 43,73,83,93 — Executing an illegal command. 
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APPENDIX B — Cable Diagrams t | 


Cables used to connect other computers, modems, or terminals to the RS232 Interface 
Card must use EIA RS232C 25-pin male connectors. For the first serial I/O port 
(RS232/1), the pins are defined as follows: 


Pin # Mnemonic Output/Input Function 
] Ground Protective ground 
2 RD Input Serial data into RS232/1 
3 TX Output Serial data out of RS232/1 
5 CTS Output Clear to send for RS232/1 
6 DSR Output Data set ready (1.8-kilohm pull-up resistor to 
+ 12V) 
7 Ground Logic or signal ground 
8 DCD Output Data carrier detect for RS232/1 
20 DTR Input Data terminal ready for RS232/1 


Pins listed above are required in either one or both of the cables diagrammed below. 
All unlisted pins need not be wired. It does not matter which end of the cable you plug 
into the RS232 Interface Card or the device. Be sure both ends are wired as follows: 


Required Pin Wiring for Connecting Two Home Computers 
Either by Direct Cables or Modems 


| 
| 
| 
| 
| 


RS232 Computer/Modem c 


ONOWN 
i) 
ONONWeH 


2 


Required Pin Wiring for Terminals 


RS232 Terminal 
1 1 
2 2 
3 3 
5* 5 
6* 6 
7 7 
8* 8 
20 20 


*Not required for proper operation of the RS232 Interface Card, but may 
be required for proper operation of accessory devices. 
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If a Y-cable is made for connecting a device to the second serial I/O port (RS232/2), the 
pins are defined as follows: 


Pin # Mnemonic Output/Input Function 


] Ground Protective ground 
6 DSR Output Data set ready (1.8-kilohm pull-up 
resistor to + 12V) 
7 Ground Logic or signal ground 
12 DCD Output Data carrier detect for RS232/2 
13 CTS Output Clear to send for RS232/2 
14 RD Input Serial data into RS232/2 
16 TX Output Serial data out of RS232/2 
19 DTR Input Data terminal ready for RS232/2 


The preceding pin-definition information can be used to make a Y-cable as follows. 


Required Pin Wiring for Connecting Two Devices 
to the RS232 Interface Card 


RS232/1 Device 1 RS232/2 Device 2 
1 1 1 1 
2 2 14 2 
a 3 16 3 
5* 5 is” 2 
6* 6 S* 6 
7 7  - ‘s 
8* 8 12° 8 
20 20 19 20 


*Not required for proper operation of the RS232 Interface Card, but may 
be required for proper operation of accessory devices. 


The pins for the parallel I/O port are defined as follows. 


Pin # Function/Description 
] Handshake OUT 
2 Data, LSB 
3 Data 
+ Data 
D Data 
6 Data 
7 Data 
8 Data 
9 Data, MSB 
10 Handshake IN 
11 Logic ground 
12 10-ohm pull-up resistor to +5V 
13 Spare input bit 
14 Spare output bit 
15 1-kilohm pull-up resistor to +5V 
16 Logic ground 


tn CR ae 6 ia ICRA aR lb EA RAN 2 RRS SABA Ca NS Be 2 FEN RRR tS A anna a pene ee eere ee mee 
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APPENDIX C — Pin Diagrams 


RS232 Female Connector Data Set Pin Definitions 


Pin # 


Type 


Driven 
Received 
Driven 
Driven 
Driven 
Driven 
Driven 
Driven 
Driven 
Received 
Driven 
Received 
Received 


Function 


Protective ground 

Data to UARTO 

Data from UARTO 

Clear to send CRU out, UO 
1.8 kilohm pull-up resistor to + 12V 
Logic ground 

Data carrier detect UARTO 
Data carrier detect UART1 
Clear to send CRU out, Ul 
Data to UART1 

Data from UART1 

Data terminal ready UART1 
Data terminal ready UARTO 
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GLOSSARY 


ASCII — The American Standard Code for Information Interchange which is a 
standard data transmission code that was introduced to achieve compatibility between 
data devices. It consists of seven information bits and one parity bit for error-checking 
purposes, thus allowing 128 code combinations. If the eighth bit is not used for parity, 
256 code combinations are possible. 


Baud — The transmission rate of data over a communication line. 300 baud indicates 
300 bits of information are being transmitted every second. 


Byte — A string of binary digits or bits treated as a unit, often representing one data 
character. 


Echo — The immediate retransmission of data just received. The data is returned to 
the sender. 


Default — The operating mode assumed when a software switch option is not entered. 


Parity — A means for checking that the data received matches the data transmitted. 
This data checking method is used to verify that the total number of data bits per 
character is always even or always odd, thus enabling tests to be made for accurate 


F 
| 
Bit — The fundamental unit of binary information symbolized by O (off) and 1 (on). 
| 
f 
| 
data transmission. | 

| 


RS232C — A serial communication interface standardized by the Electronic Industries 
Association (EIA). 


27 


THREE-MONTH LIMITED WARRANTY 


THIS TEXAS INSTRUMENTS RS232 INTERFACE CARD WARRANTY EXTENDS TO 
THE ORIGINAL CONSUMER PURCHASER OF THE ACCESSORY. 


WARRANTY DURATION 


This RS232 Interface Card is warranted for a period of three (3) months from the date of the 
original purchase by the consumer. 


WARRANTY COVERAGE 


This RS232 Interface Card is warranted against defective materials or workmanship. 
THIS WARRANTY IS VOID IF THE ACCESSORY HAS BEEN DAMAGED BY 
ACCIDENT, UNREASONABLE USE, NEGLECT, IMPROPER SERVICE OR OTHER 
CAUSES NOT ARISING OUT OF DEFECTS IN MATERIALS OR WORKMANSHIP. 


WARRANTY DISCLAIMERS 


ANY IMPLIED WARRANTIES ARISING OUT OF THIS SALE, INCLUDING BUT NOT 
LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
FOR A PARTICULAR PURPOSE, ARE LIMITED IN DURATION TO THE ABOVE 
THREE-MONTH PERIOD. TEXAS INSTRUMENTS SHALL NOT BE LIABLE FOR LOSS 
OF USE OF THE HARDWARE OR OTHER INCIDENTAL OR CONSEQUENTIAL COSTS, 
EXPENSES, OR DAMAGES INCURRED BY THE CONSUMER OR ANY OTHER USER. 


Some states do not allow the exclusion or limitation of implied warranties or consequential 
damages, so the above limitations or exclusions may not apply to you in those states. 


LEGAL REMEDIES 


This warranty gives you specific legal rights, and you may also have other rights that vary 
from state to state. 


WARRANTY PERFORMANCE 


During the above three-month warranty period, your RS232 Interface Card will be repaired 
or replaced with a new or reconditioned unit of the same or equivalent model (at TI’s option) 
when the unit is returned by prepaid shipment to a Texas Instruments Service Facility listed 
below. The repaired or replacement unit will be warranted for three months from date of 
repair or replacement. Other than the postage requirement, no charge will be made for the 
repair or replacement of in-warranty units. 


Texas Instruments strongly recommends that you insure the unit for value, prior to shipment. 
TEXAS INSTRUMENTS CONSUMER SERVICE FACILITIES 


U.S. Residents Canadian Residents 

Texas Instruments Service Facility Geophysical Services Incorporated 

2303 North University 41 Shelley Road 

Lubbock, Texas 79415 Richmond Hill, Ontario, Canada L4C5G4 


Consumers in California and Oregon may contact the following Texas Instruments offices for 


additional assistance or information: 
Texas Instruments Consumer Service 


Texas Instruments Consumer Service 6700 Southwest 105th 
831 South Douglas Street Kristin Square, Suite 110 
El Segundo, California 90245 Beaverton, Oregon 97005 
(213)973-1803 (503)643-6758 
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PRINTED IN U.S.A. 


Texas Instruments invented the integrated circuit, 
the microprocessor, and the microcomputer. 
Being first is our tradition. 
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TEXAS INSTRUMENTS 


INCORPORATED 
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